home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / lib / tclX-6.4 / help / debug / cmdtrace < prev    next >
Encoding:
Text File  |  1992-12-17  |  2.3 KB  |  53 lines
  1.  
  2.  
  3.           cmdtrace level|on [noeval] [notruncate] [flush] [procs]
  4.                Print a trace statement for all commands executed at
  5.                depth of level or below (1 is the top level).  If on is
  6.                specified, all commands at any level are traced.  The
  7.                following options are available:
  8.  
  9.                noeval
  10.                     Causes arguments to be printed unevaluated.  If
  11.                     noeval is specified, the arguments are printed
  12.                     before evaluation.  Otherwise, they are printed
  13.                     afterwards.
  14.  
  15.                      If the command line is longer than 60 characters,
  16.                     it is truncated to 60 and a "..." is postpended to
  17.                     indicate that there was more output than was
  18.                     displayed.  If an evaluated argument contains a
  19.                     space, the entire argument will be enclosed inside
  20.                     of braces (`{}') to allow the reader to visually
  21.                     separate the arguments from each other.
  22.  
  23.                notruncate
  24.                     Disables the truncation of commands and evaluated
  25.                     arguments.
  26.  
  27.                flush
  28.                     Causes the output buffer to be flushed after each
  29.                     line is printed.  This is useful when tracing C
  30.                     code that cause an application to abort, making it
  31.                     easy to narrow the problem down to the command
  32.                     that caused the abort.
  33.  
  34.                procs
  35.                     Enables the tracing of procedure calls only.
  36.                     Commands that aren't procedure calls (i.e. calls
  37.                     to commands that are written in C, C++ or some
  38.                     object-compatible language) are not traced if the
  39.                     procs option is specified.  This option is
  40.                     particularly useful for greatly reducing the
  41.                     output of cmdtrace while debugging.
  42.  
  43.                filehandle
  44.                     If specified, then the trace output will be
  45.                     written to the file rather than stdout.
  46.  
  47.           cmdtrace off
  48.                Turn off all tracing.
  49.  
  50.           cmdtrace depth
  51.                Returns the current maximum trace level, or zero if
  52.                trace is disabled.
  53.